home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / gt_power / gtusrd10.zip / GTUSRDMP.DOC next >
Text File  |  1991-12-07  |  4KB  |  83 lines
  1.  
  2.     ┌─────────────────────────────────────────────────────────────────────┐
  3.     │                          GT User Dump v1.0                          │
  4.     └─────────────────────────────────────────────────────────────────────┘
  5.                                       by
  6.  
  7.                         Douglas Pippel - GTNet 075/001
  8.  
  9.                                Released 12/6/91
  10.  
  11.  
  12.     GT  User  Dump  is a quick and dirty little utility that I wrote out of
  13.     frustration. I was building a user database  application  with  Clarion
  14.     and  searched  high and low, to no avail, for a program that would dump
  15.     GT  Power's  USER.CTL  file to a proper comma-delimited database import
  16.     format. Hence GT User Dump.
  17.  
  18.  
  19.     ┌─────────────────────────────────────────────────────────────────────┐
  20.     │                            What It Do Do                            │
  21.     └─────────────────────────────────────────────────────────────────────┘
  22.  
  23.     This program will read your USER.CTL and create a straight  ASCII  file
  24.     from  it.  Output is one record per line (terminated with a CR), fields
  25.     are enclosed by quotes ("John Doe")  and  delimited  by  commas  ("John
  26.     Doe","Anytown,  Florida").  This  is  the  standard  "BASIC" or "ASCII"
  27.     import  file format used by most popular database programs such as Q&A,
  28.     R:Base, Clarion, etc.
  29.  
  30.     Field order is as follows:
  31.  
  32.     User Name, date of first call, time of first call, date of  last  call,
  33.     time  of  last  call, netmail credits, netmail charges, number of times
  34.     on, banned flag, expert mode  flag,  nonstop  flag,  city/state,  phone
  35.     number,  password,  access level, calls today, acummulated time, screen
  36.     length, uploaded kb, uploaded files, downloaded kb,  downloaded  files,
  37.     caller  number,  expiration  date, time bank, downloaded kb today, time
  38.     bank deposits today, time bank withdrawals today.
  39.  
  40.     I have omitted the deleted flag, protocol,  hash  code  and  CB  handle
  41.     fields since they are either transient data or are of no practical use.
  42.  
  43.  
  44.     ┌─────────────────────────────────────────────────────────────────────┐
  45.     │                            How To Do It                             │
  46.     └─────────────────────────────────────────────────────────────────────┘
  47.  
  48.     To use GT User Dump, merely copy the program into any directory defined
  49.     in your DOS path, change to your GTPATH directory and enter GTUSRDMP at
  50.     the command line. That's all there is to it.  You  *MUST*  be  in  your
  51.     GTPATH  directory  for  the  program  to  work...I didn't make it smart
  52.     <grin>. An output file named GTUSRDMP.ASC will be created in the GTPATH
  53.     directory. You can then import the data  into  your  favorite  database
  54.     program  and  look  at  all  of  the  wonderful users you have, perform
  55.     calculus on their upload/download ratios, twiddle their  bits  or  what
  56.     have you.
  57.  
  58.                          ──────────────────────────────
  59.  
  60.     GT User Dump v1.0 is ***GT 17.00 SPECIFIC*** !!!  To  my  knowledge  it
  61.     will  *NOT*  work  with  any  other  version  of GT Power, has not been
  62.     tested with any other version of GT Power, and may indeed TOTALLY TRASH
  63.     your user file if you try to run it with any other version of GT Power.
  64.     There - you can't say that I didn't warn you <grin>.
  65.  
  66.     GT  User Dump is absolutely FREE. You really wouldn't want to pay money
  67.     for something like this anyway. It may be distributed with whatever you
  68.     like and used however, wherever and with whomever you like.
  69.  
  70.     DISCLAIMER:  Use  this  program ENTIRELY at your own risk! There are no
  71.     warranties  expressed or implied. The author will not be reponsible for
  72.     loss of data (or anything else) that  results  from  the  use  of  this
  73.     program.
  74.  
  75.  
  76.     If I get ambituous and there is a need, I may add some enhancements  to
  77.     the  program  such  as  GTPATH  recognition,  skipping  deleted  users,
  78.     user-selectable record dumps, user-defined field  delimiters,  etc.  in
  79.     the  future.  However,  please don't hold your breath. For anyone who's
  80.     interested,  this  program  was  written   using   Borland   C++   v2.0
  81.     Professional.
  82.  
  83.